home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / util4 / bootctrl.lha / BootControl / BootControl.doc < prev    next >
Text File  |  1995-04-21  |  12KB  |  487 lines
  1. BootControl 2.1 (18.04.95) © 1995 Elaborate Bytes, Oliver Kastl
  2.  
  3. Welcome to BootControl!
  4.  
  5. DISCLAIMER
  6.  
  7.  This software is subject to the "Standard Amiga FD-Software Copyright Note"
  8.  It is SHAREWARE as defined in paragraph 4s.
  9.  If you like it and use it regularly please send DM 30,- to the address listed
  10.  below.
  11.  For more information please read "AFD-COPYRIGHT" (Version 1 or higher).
  12.  
  13.  
  14.  
  15. REQUIREMENTS
  16.  
  17. This program requires Kickstart 3.0 or better.
  18. For the VGA default monitor trick an AA/AGA Amiga (A1200, A4000) is required.
  19.  
  20.  
  21.  
  22. PURPOSE
  23.  
  24. This program allows you:
  25.  
  26. - To change your Amiga between NTSC and PAL, without using the
  27.   BootMenu. This method is better than switchin the PAL/NTSC jumper, as the
  28.   system timers may run incorrectly!
  29.  
  30. - Use the DblNTSC monitor as the default monitor. If you only have a VGA
  31.   monitor, you will be able to see the BootMenu! If your Amiga aborts the
  32.   startup-sequence for some reason, or if you select "Boot without startup-
  33.   sequence" from the BootMenu, you will get an DblNTSC screen!
  34.  
  35. - Redirect DisplayAlerts to EasyRequests, so you can see them with graphic
  36.   cards and VGA monitors.
  37.  
  38. - Remove harddisk partitions from the system
  39.  
  40. - Change the partition you wish to boot from
  41.  
  42. - Emulate the OCS and ECS chip sets on AA Amigas
  43.  
  44. - Other system degrations like NoFastMem, CacheControl, etc.
  45.  
  46. - All your settings will be stored reset resident in the system!
  47.  
  48.  
  49.  
  50. HOW IT WORKS
  51.  
  52. BootControl adds two reset resident romtags to the system.
  53. After you installed BootControl, the settings will be effective after
  54. you rebootet your machine.
  55.  
  56. All settings will be kept until you switch off the Amiga or you alter them
  57. either with BootControl or the Amiga early startup BootMenu.
  58.  
  59. BootControl can be started from the CLI only.
  60. It will crash your machine if you try to start it from Workbench.
  61.  
  62.  
  63. INSTALLATION
  64.  
  65. Copy BootControl to your C: directory.
  66. Put the line
  67.  
  68. BootControl install boot quiet [options]
  69.  
  70. early in your startup-sequence, where options are discussed later.
  71.  
  72. VGA monitor users should create a "emergency" disk with
  73. BootControl install boot quiet [options]
  74. as the first line of the startup-sequence of this floppy.
  75. If you have a severe problem or if you like to reinstall your harddisk
  76. simply boot with this disk. After a while you should be able to see
  77. something.
  78.  
  79. If you wish to use the VGA mode of BootControl, you should remove the
  80. VGAONLY and DblNTSC monitor from your devs:Monitors directory as they are
  81. no longer needed.
  82.  
  83.  
  84.  
  85. BOOTCONTROL OPTIONS (in order if appearance)
  86.  
  87. MODE
  88.  
  89. Sets the display mode of your machine for the next boot.
  90.  
  91. Can be NTSC, PAL or VGA.
  92.  
  93. NTSC - Boot in NTSC mode
  94. PAL - Boot in PAL mode
  95. VGA - Boot in VGA (DblNTSC) mode
  96.  
  97. Example: BootControl MODE=NTSC
  98.  
  99. The default will be the current display mode of your machine.
  100.  
  101. If you use the Amiga Early Startup control (bootmenu), this value will
  102. be overridden if you didn't specify MODE=VGA.
  103.  
  104. If VGA is specified, a DblNTSC monitor will be added to the system on the
  105. next boot. This monitor will NOT be added, if you do NOT specify MODE=VGA
  106. for compatibility reasons with some games.
  107. You can force the initialisation of the DblNTSC monitor by specifying the
  108. switch LOADVGA (see below).
  109.  
  110.  
  111.  
  112. READICON
  113.  
  114. If you start BootControl with READICON, BootControl will
  115. look  for the file DblNTSC.info in your devs:Monitors drawer.
  116. If it can't be found there, it will look for it in your SYS:Storage/Monitors
  117. drawer.
  118. This will always happen, even if the current mode is NOT VGA.
  119. However, if you switch to VGA later these settings will be used.
  120.  
  121. If the file can be found, any relevant tooltypes will be read and will be
  122. used for the next reboot. These tooltypes can be created by MonED.
  123.  
  124. Known tooltypes are:
  125.  
  126. HBSTRT
  127. HBSTOP
  128. VBSTRT
  129. VBSTOP
  130. MINCOL
  131. MINROW
  132. TOTROWS
  133. TOTCLKS
  134. BEAMCON0
  135.  
  136. These tooltypes must be followed by a HEX number preceeded with 0x.
  137.  
  138. E.g., TOTCLKS=0x79
  139.  
  140. This is exactly the format MonED uses.
  141.  
  142. Simply start MonED, set the desired values and click SAVE.
  143. Then type BootControl MODE VGA READICON and reboot.
  144.  
  145. NOTE:
  146.  
  147. The READICON feature is not much tested, as I don't use MonED regulary.
  148.  
  149. Example: BootControl MODE=VGA READICON
  150.  
  151. READICON will be ignored, if RESET is specified (see below).
  152.  
  153.  
  154.  
  155. RESETVGA
  156.  
  157. Resets the DblNTSC settings back to defaults. This will cancel a previously
  158. done READICON operation.
  159.  
  160. Example: BootControl RESETVGA
  161.  
  162.  
  163.  
  164. LOADVGA
  165.  
  166. Forces the usage of the embedded DblNTSC, even if MODE=VGA was not specified.
  167. This will use the otherwise unused 8 kByte of the embedded DblNTSC
  168. monitor.
  169.  
  170. Example: BootControl MODE NTSC LOADVGA
  171.  
  172.  
  173.  
  174. NOLOADVGA
  175.  
  176. Will not load the DblNTSC monitor. Is ignored, if MODE=VGA is set.
  177.  
  178.  
  179.  
  180. VGAONLY
  181.  
  182. Forces VGAONLY mode for the next boot.
  183. Is the default, if BootControl is installed after VGAONLY has been started.
  184.  
  185. This happens regardless if you have set the MODE to VGA or not.
  186.  
  187. If you use MODE=VGA and you usually use the VGAONLY monitor,
  188. you must set this flag.
  189.  
  190. Example: BootControl MODE=VGA VGAONLY
  191.  
  192.  
  193.  
  194. NOVGAONLY
  195.  
  196. Disables VGAONLY mode for the next boot.
  197. Is the default, if BootControl is installed and VGAONLY has not been
  198. started.
  199.  
  200. This happens regardless if you have set the MODE to VGA or not.
  201.  
  202. If you use MODE=VGA and you usually do not use the VGAONLY monitor,
  203. you must set this flag.
  204.  
  205. Example: BootControl MODE=VGA NOVGAONLY
  206.  
  207.  
  208.  
  209. GFX
  210.  
  211. Sets the graphics (chipset) mode of your machine for the next boot.
  212.  
  213. Can be OLD, ECS, BEST or DEFAULT.
  214. Will be ignored, if MODE is set to VGA or LOADVGA is specified,
  215. as this implies BEST.
  216.  
  217. DEFAULT - Don't change anything
  218. OLD - Boot in OLD chipset mode
  219. ECS - Boot in ECS chipset mode
  220. BEST - Force machine to its best (AA/AGA, if possible) mode
  221. AA/AGA modes will be available even if SetPatch hasn't been started.
  222.  
  223. Example: BootControl MODE=NTSC GFX=BEST
  224.  
  225. If you use the Amiga Early Startup control (bootmenu), this value will
  226. be overridden if you didn't specify MODE=VGA.
  227.  
  228.  
  229.  
  230. FASTMEM
  231.  
  232. Enable all FastMem (Default)
  233.  
  234. Example: BootControl MODE=NTSC GFX=BEST FASTMEM
  235.  
  236.  
  237.  
  238. NOFASTMEM
  239.  
  240. Disable all FastMem
  241.  
  242. Example: BootControl MODE=VGA NOFASTMEM
  243.  
  244.  
  245.  
  246. PATCHALERT
  247.  
  248. Patches DisplayAlert() (e.g., Gurus) to be visible on your
  249. default public screen.
  250.  
  251. Example: BootControl MODE=VGA VGAONLY PATCHALERT
  252.  
  253.  
  254.  
  255. NOPATCHALERT
  256.  
  257. Removes the DisplayAlert() patch (default).
  258.  
  259. Example: BootControl MODE=NTSC GFX=ECS NOPATCHALERT
  260.  
  261.  
  262.  
  263. CACHE
  264.  
  265. Sets the CPU cache settings for the next boot.
  266.  
  267. Can be OFF, ON, FORCE.
  268.  
  269. OFF - Disable all caches
  270. ON - Leave the instruction cache on (default)
  271. FORCE - Force machine to use instruction & data caches
  272. The data cache will be available even if SetPatch hasn't been started.
  273.  
  274. Example: BootControl MODE=NTSC GFX=BEST CACHE=FORCE
  275.  
  276. If you use the Amiga Early Startup control (bootmenu), this value will
  277. be overridden.
  278.  
  279.  
  280.  
  281. CHIPRED
  282.  
  283. Reduces the amount of available Chip memory for the next boot.
  284. Value is in kBytes (Default is 0)
  285.  
  286. Example: BootControl MODE=NTSC GFX=BEST CACHE=FORCE CHIPRED=1024
  287.  
  288. Will reduce chip memory to 1 MByte on machines with 2 MByte chip memory.
  289.  
  290.  
  291.  
  292. FASTRED
  293.  
  294. Reduces the amount of available Fast memory for the next boot.
  295. Value is in kBytes (Default is 0)
  296.  
  297. Example: BootControl MODE=NTSC GFX=BEST CACHE=FORCE FASTRED=2048
  298.  
  299. Will reduce fast memory by 2 MByte.
  300.  
  301.  
  302.  
  303. BOOTDEV
  304.  
  305. Here you can specify the DOS device you wish to boot from next.
  306. Do NOT add colons to the name!
  307.  
  308. Example: BootControl BOOTDEV=DH2
  309.  
  310. Will boot from DH2:
  311.  
  312. To reset to the default booting scheme, type
  313. BootControl BOOTDEV=""
  314.  
  315. If you use the Amiga Early Startup control (bootmenu), this value will
  316. be overridden.
  317.  
  318.  
  319. INSTALL
  320.  
  321. Must be specified if you run BootControl for the first time.
  322. If BootControl is already running, all other options will be ignored.
  323.  
  324. Example: BootControl INSTALL BOOT QUIET MODE=VGA VGAONLY PATCHALERT
  325.  
  326. This is a typical startup-sequence line for the user of an VGA monitor.
  327.  
  328.  
  329.  
  330. REMOVE
  331.  
  332. Opposite of INSTALL. Will be ignored, if INSTALL is specified.
  333.  
  334. Example: BootControl REMOVE
  335.  
  336. After BootControl is removed, it can be installed again.
  337.  
  338. Note: The occupied memory will be freed after a reboot.
  339.  
  340.  
  341.  
  342. BOOT
  343.  
  344. Will reboot your machine, after the settings have been changed.
  345. If BOOT is specified together with INSTALL, the machine will only
  346. reboot if BootControl is run for the first time.
  347.  
  348.  
  349.  
  350. QUIET
  351.  
  352. Disables the output of status information.
  353.  
  354.  
  355.  
  356. HIDDEN
  357.  
  358. Here you can enter a list of DOS devices which you don't want to be mounted
  359. if you reboot.
  360. Do NOT add colons to the name!
  361.  
  362. Example: BootControl HIDDEN=DH2 DH3 VMEM
  363.  
  364. This will hide DH2:, DH3: and VMEM:
  365.  
  366. NOTE: A device specified with BOOTDEV will NOT be hidden!
  367. This is helpful if you wish to use the BootMenu.
  368.  
  369. To reset to the default, type
  370. BootControl HIDDEN=""
  371.  
  372.  
  373.  
  374. USING THE AMIGA EARLY STARTUP BOOTMENU
  375.  
  376. The BootMenu can still be used if BootControl is installed.
  377. If you use MODE=VGA, do not press any key during the time the BootMenu
  378. screen is visible as the display will be trashed.
  379. If you select a boot device in BootMenu, BootControl will use this device
  380. automatically and will store this value reset resident.
  381. If you switch display modes within BootMenu (NTSC/PAL, OLD/ECS/BEST)
  382. these values will be passed to BootControl if it is installed and will
  383. be stored reset resident. Exception to this rule: If you use MODE=VGA
  384. these settings are ignored.
  385. One interesting thing: If you select "BEST" within BootMenu, this will
  386. imply GFX=BEST for the NEXT BOOT.
  387. If you didn't specify BEST from BootControl, all following boots
  388. will have GFX=DEFAULT.
  389.  
  390.  
  391.  
  392. MEMORY USAGE
  393.  
  394. BootControl will constantly need about 10 kByte of memory once it is
  395. installed. Please note that this includes the DblNTSC monitor, which
  396. alone occupies about 8 kByte.
  397.  
  398.  
  399.  
  400. THANKS
  401.  
  402. Special thanks go to Stefan Scherer for his AAStarter program which
  403. inspired me a lot.
  404. Until I saw this program, I didn't believe that the VGA "hack" can be
  405. done.
  406. Thanks go to Ralph Babel for the idea of a second RomTag and for his
  407. wonderful Amiga Guru book.
  408.  
  409.  
  410.  
  411.  
  412. NOTES FOR PROGRAMMERS
  413.  
  414. I will write a seperate documentation how to use the BootControl.resource
  415. for your own needs. There is a reserved field which you can use if you
  416. wish to keep some values reset resident.
  417. I am open for any good ideas!
  418.  
  419. For your information I have included the Assembler & C Headerfiles.
  420. If you wish to assign currently unused flags for your application, please
  421. contact me.
  422.  
  423.  
  424.  
  425. SHAREWARE
  426.  
  427. As previously stated, this program is shareware.
  428. If you like it and if you wish to use it frequently, please send DM 30,- to:
  429.  
  430.  
  431. Elaborate Bytes, Oliver Kastl
  432. Am Westpark 5
  433. 81373 Munich
  434. Germany
  435.  
  436. Compuserve: 100447,3361
  437. Internet: 100447.3361@compuserve.com
  438.  
  439.  
  440. I don't think this is too much, as this program saves you some money (you don't need
  441. a ScanDoubler any more).
  442.  
  443. Please send comments & suggestions!
  444.  
  445. This program was made for YOU!
  446.  
  447.  
  448.  
  449. HISTORY
  450.  
  451.  
  452. Version 1.3
  453.  
  454. First public release.
  455.  
  456.  
  457.  
  458. Version 1.4
  459.  
  460. Some minor bugs fixed.
  461. Gives more help, if a wrong keyword was specified.
  462. Changed "FORCEAGA" GfxMode to "BEST", as this was misleading.
  463. Passes PAL/NTSC and OLD/ECS/BEST values from BootMenu to BootControl
  464. Now can read MonED settings from DblNTSC monitor file.
  465. Added switches READICON and RESET for this purpose.
  466. Embedded DblNTSC monitor can be used, if MODE was different from VGA.
  467. Added switches LOADVGA and NOLOADVGA for this purpose.
  468. On first install, checks if VGAONLY was run and sets this as the default.
  469. On first install, checks if DblNTSC.monitor is present and sets LOADVGA or
  470. NOLOADVGA as defaults.
  471. Some changes to the documentation.
  472.  
  473.  
  474.  
  475. Version 2.1
  476.  
  477. Major bugfix: LOADVGA could crash the machine!
  478. Code optimized, size reduced
  479. Better error checking
  480. Better output format
  481. REMOVE option added
  482. Gives now error messages on invalid tooltype values in DblNTSC icon
  483. Uses now a library header instead of a Node
  484. First public release of include files
  485. Bumped version number because of major changes
  486.  
  487.